home *** CD-ROM | disk | FTP | other *** search
/ Amiga Developer CD 2.1 / Amiga Developer CD v2.1.iso / Reference / DevCon / Orlando_1993 / Devcon93.4 / Networking2 / SANA2 / changes.txt < prev    next >
Encoding:
Text File  |  1993-01-11  |  4.0 KB  |  79 lines
  1. Changes
  2.  
  3. December 16, 1992:   v1.5
  4.  
  5. - previous to this release, the "examples/device_funcs.c" file contained
  6. references to two, obsolete #defines that were not in the include files. 
  7. These defines are 'S2_ADDSTATIONALIAS' and 'S2_DELSTATIONALIAS'. Again,
  8. these are _obsolete_.
  9.  
  10. The file "device_funcs.c" has had the two, offending lines removed. No
  11. other changes have been made to the archived files (except for relevant
  12. doc files like this one.)
  13.  
  14. November 12th, 1992:  v1.4
  15.  
  16. - Previous to this release, the SANA-II structure Sana2DeviceStats was
  17. defined differently in sana2.h and sana2.i.  The assembly include file
  18. contained an erroneous entry for a field labelled 'SoftMisses'.  This
  19. field had been removed from the 'C' header file, but never from the
  20. assembly include.  To resolve this problem, this field in the assembly
  21. file has been kept (to preserve structure size), but marked as "Unused".
  22. A ULONG has been added at the appropriate location in the header file,
  23. and also marked as "unused".  If you were using the header file
  24. definition for this structure, please take note that the structure size
  25. has -changed-!
  26.  
  27. - The SLIP and CSLIP drivers have been included in this archive.  These
  28. drivers are primarily useful only to an IP-based protocol stack, but
  29. can be used in other applications.  See the documentation in driver_docs
  30. for more information.
  31.  
  32. May, 1992:
  33.  
  34. There have been no substantive changes from the Novemeber 7 Draft for Final
  35. Comment and approval.  There have been minor clarifications and typographical
  36. corrections and a section was added to clarify ARCNET framing.
  37.  
  38. Since the Fish Disk/'91 DevCon draft of the SANA-II standard, here is a
  39. summary list of the important changes:
  40.  
  41. - Packet type specification has been drastically simplified.  The original
  42. standard called for a generalized "Packet Magic" which all drivers and
  43. protocols had to deal with, even though few people should ever have to worry
  44. about the problem.  We could also have specified that there are 802.3 SANA-II
  45. drivers and that there are ethernet drivers and that if you want 802.3 and
  46. ethernet (even if on the same wire) from the same machine, use two ethernet
  47. boards.  This didn't make sense because we don't anticipate multiple protocols
  48. needing to use 802.3 frames nor much encouragement for hardware manufactures
  49. to provide special 802.3 drivers.  The current solution keeps the standard
  50. simple and allows highly efficient implementations, but it does make ethernet
  51. drivers a little more complex and does make using 802.3 frames harder.
  52.  
  53.  
  54. - The original SANA-II device driver specification therefore called for
  55. drivers to have no internal buffers and to get all buffers from protocols in
  56. the form of a data structure called a NetBuff. Hence, all protocols were
  57. required to use NetBuffs.  This was highly unsatisfactory since most
  58. protocols are implemented from an existing code base which includes its own
  59. buffer management scheme.  NetBuffs are removed from the standard and
  60. replaced with a function callback.
  61.  
  62. - The original standard called for an interface to the ability of some hardware
  63. to simultaneously accept packets for several hardware addresses.  Such a
  64. feature is of dubious usefulness.  In order to simplify the standard, station
  65. aliases are no longer part of the SANA-II Network Device Driver Specification.
  66. If station aliasing does turn out to be a useful feature available on some
  67. hardware for the Amiga, the standard can easily be extended to re-introduce
  68. station aliasing.  Remember that all Exec drivers must check for io_Command
  69. values not supported by the driver. Hence, SANA-II commands can be added
  70. without requiring that existing drivers be rev'd.
  71.  
  72. - Since the IOSana2Req structure had to be changed anyway, many names in
  73. <devices/sana2.h> have been changed to be more consistent with other system
  74. names. It is believed that global search and replace should make this a mostly
  75. trivial change and that the benefits gained from consistent naming outweigh
  76. the inconvenience to those few who have existing SANA-II code.
  77.  
  78. - Events are now defined as a bit mask rather than as scalars.
  79.